home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1993 July / InfoMagic USENET CD-ROM July 1993.ISO / sources / misc / volume29 / zsh2.2 / part01 next >
Encoding:
Text File  |  1992-05-13  |  49.1 KB  |  1,653 lines
  1. Newsgroups: comp.sources.misc
  2. From: pfalstad@phoenix.Princeton.EDU (Paul Falstad)
  3. Subject:  v29i097:  zsh2.2 - The Z shell, Part01/17
  4. Message-ID: <csm-v29i097=zsh2.2.103215@sparky.IMD.Sterling.COM>
  5. X-Md4-Signature: 6c35d02622176e5f8e7212cd57a60307
  6. Date: Wed, 13 May 1992 15:52:04 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: pfalstad@phoenix.Princeton.EDU (Paul Falstad)
  10. Posting-number: Volume 29, Issue 97
  11. Archive-name: zsh2.2/part01
  12. Environment: BSD
  13. Supersedes: zsh2.1: Volume 24, Issue 1-19
  14.  
  15. #!/bin/sh
  16. # This is zsh2.2, a shell archive (produced by shar 3.49)
  17. # To extract the files from this archive, save it to a file, remove
  18. # everything above the "!/bin/sh" line above, and type "sh file_name".
  19. #
  20. # made 05/12/1992 04:14 UTC by pfalstad@phoenix
  21. # Source directory /n/homeserver/g/pfalstad
  22. #
  23. # existing files will NOT be overwritten unless -c is specified
  24. #
  25. # This is part 1 of a multipart archive                                    
  26. # do not concatenate these parts, unpack them in order with /bin/sh        
  27. #
  28. # This shar contains:
  29. # length  mode       name
  30. # ------ ---------- ------------------------------------------
  31. #   2684 -rw-r--r-- zsh2.2/FEATURES
  32. #    505 -rw-r--r-- zsh2.2/NOTES
  33. #  17490 -rw-r--r-- zsh2.2/README
  34. #  58603 -rw-r--r-- zsh2.2/doc/intro.txt
  35. #    247 -rw-r--r-- zsh2.2/dots/zlogin
  36. #   2291 -rw-r--r-- zsh2.2/dots/zshrc
  37. #    123 -rw-r--r-- zsh2.2/dots/zshenv
  38. #    104 -rwxr-xr-x zsh2.2/func/acx
  39. #    109 -rwxr-xr-x zsh2.2/func/cx
  40. #     97 -rwxr-xr-x zsh2.2/func/harden
  41. #     84 -rwxr-xr-x zsh2.2/func/mere
  42. #    412 -rwxr-xr-x zsh2.2/func/namedir
  43. #    194 -rwxr-xr-x zsh2.2/func/proto
  44. #     80 -rwxr-xr-x zsh2.2/func/randline
  45. #     29 -rwxr-xr-x zsh2.2/func/yp
  46. #     35 -rwxr-xr-x zsh2.2/func/yu
  47. # 112852 -rw-r--r-- zsh2.2/man/man1/zsh.1
  48. #    755 -rwxr-xr-x zsh2.2/scripts/aproto
  49. #    173 -rwxr-xr-x zsh2.2/scripts/fproto
  50. #   1137 -rw-r--r-- zsh2.2/scripts/ctoz
  51. #   2958 -rw-r--r-- zsh2.2/scripts/fooz
  52. #   3299 -rwxr-xr-x zsh2.2/scripts/c2z
  53. #   2736 -rwxr-xr-x zsh2.2/scripts/c2z.orig
  54. #  11626 -rwxr-xr-x zsh2.2/src/buildzsh
  55. #  61945 -rw-r--r-- zsh2.2/src/builtin.c
  56. #   4064 -rw-r--r-- zsh2.2/src/cond.c
  57. #  35818 -rw-r--r-- zsh2.2/src/exec.c
  58. #   1185 -rw-r--r-- zsh2.2/src/funcs.h
  59. #  24554 -rw-r--r-- zsh2.2/src/glob.c
  60. #  23511 -rw-r--r-- zsh2.2/src/hist.c
  61. #  11807 -rw-r--r-- zsh2.2/src/init.c
  62. #  16421 -rw-r--r-- zsh2.2/src/jobs.c
  63. #  15554 -rw-r--r-- zsh2.2/src/lex.c
  64. #   4752 -rw-r--r-- zsh2.2/src/loop.c
  65. #  10185 -rw-r--r-- zsh2.2/src/math.c
  66. #   4948 -rw-r--r-- zsh2.2/src/mem.c
  67. #  24577 -rw-r--r-- zsh2.2/src/params.c
  68. #  14912 -rw-r--r-- zsh2.2/src/subst.c
  69. #   6810 -rw-r--r-- zsh2.2/src/table.c
  70. #   8584 -rw-r--r-- zsh2.2/src/text.c
  71. #  32116 -rw-r--r-- zsh2.2/src/utils.c
  72. #   7149 -rw-r--r-- zsh2.2/src/watch.c
  73. #   8371 -rw-r--r-- zsh2.2/src/zle.h
  74. #  17212 -rw-r--r-- zsh2.2/src/zle_bindings.c
  75. #  14597 -rw-r--r-- zsh2.2/src/zle_main.c
  76. #  12058 -rw-r--r-- zsh2.2/src/zle_refresh.c
  77. #   4690 -rw-r--r-- zsh2.2/src/zle_utils.c
  78. #  31883 -rw-r--r-- zsh2.2/src/zsh.h
  79. #   4793 -rw-r--r-- zsh2.2/src/zle_vi.c
  80. #   1486 -rw-r--r-- zsh2.2/src/ztype.h
  81. #  26002 -rw-r--r-- zsh2.2/src/zle_tricky.c
  82. #   4239 -rw-r--r-- zsh2.2/src/builtin.pro
  83. #    235 -rw-r--r-- zsh2.2/src/cond.pro
  84. #   2306 -rw-r--r-- zsh2.2/src/exec.pro
  85. #   1511 -rw-r--r-- zsh2.2/src/glob.pro
  86. #   1989 -rw-r--r-- zsh2.2/src/hist.pro
  87. #    395 -rw-r--r-- zsh2.2/src/init.pro
  88. #    892 -rw-r--r-- zsh2.2/src/jobs.pro
  89. #    309 -rw-r--r-- zsh2.2/src/lex.pro
  90. #    206 -rw-r--r-- zsh2.2/src/loop.pro
  91. #    291 -rw-r--r-- zsh2.2/src/math.pro
  92. #    510 -rw-r--r-- zsh2.2/src/mem.pro
  93. #   3478 -rw-r--r-- zsh2.2/src/params.pro
  94. #    619 -rw-r--r-- zsh2.2/src/subst.pro
  95. #    941 -rw-r--r-- zsh2.2/src/table.pro
  96. #    371 -rw-r--r-- zsh2.2/src/text.pro
  97. #   3277 -rw-r--r-- zsh2.2/src/utils.pro
  98. #    371 -rw-r--r-- zsh2.2/src/watch.pro
  99. #      0 -rw-r--r-- zsh2.2/src/zle_bindings.pro
  100. #    686 -rw-r--r-- zsh2.2/src/zle_main.pro
  101. #    596 -rw-r--r-- zsh2.2/src/zle_refresh.pro
  102. #    761 -rw-r--r-- zsh2.2/src/zle_vi.pro
  103. #   1036 -rw-r--r-- zsh2.2/src/parse.pro
  104. #   1817 -rw-r--r-- zsh2.2/src/zle_tricky.pro
  105. #  18760 -rw-r--r-- zsh2.2/src/parse.c
  106. #    684 -rw-r--r-- zsh2.2/src/zle_utils.pro
  107. #   1429 -rw-r--r-- zsh2.2/src/signals.h.sample
  108. #   5181 -rw-r--r-- zsh2.2/src/zle_move.c
  109. #  14519 -rw-r--r-- zsh2.2/src/zle_misc.c
  110. #   6019 -rw-r--r-- zsh2.2/src/zle_word.c
  111. #  10080 -rw-r--r-- zsh2.2/src/zle_hist.c
  112. #   1119 -rw-r--r-- zsh2.2/src/zle_hist.pro
  113. #   1478 -rw-r--r-- zsh2.2/src/zle_misc.pro
  114. #    909 -rw-r--r-- zsh2.2/src/zle_move.pro
  115. #    733 -rw-r--r-- zsh2.2/src/zle_word.pro
  116. #   2607 -rw-r--r-- zsh2.2/src/config.h
  117. #   1322 -rw-r--r-- zsh2.2/src/signals.h
  118. #    921 -rw-r--r-- zsh2.2/src/Makefile
  119. #
  120. if test -r _shar_seq_.tmp; then
  121.     echo 'Must unpack archives in sequence!'
  122.     echo Please unpack part `cat _shar_seq_.tmp` next
  123.     exit 1
  124. fi
  125. # ============= zsh2.2/FEATURES ==============
  126. if test ! -d 'zsh2.2'; then
  127.     echo 'x - creating directory zsh2.2'
  128.     mkdir 'zsh2.2'
  129. fi
  130. if test -f 'zsh2.2/FEATURES' -a X"$1" != X"-c"; then
  131.     echo 'x - skipping zsh2.2/FEATURES (File already exists)'
  132.     rm -f _shar_wnt_.tmp
  133. else
  134. > _shar_wnt_.tmp
  135. echo 'x - extracting zsh2.2/FEATURES (Text)'
  136. sed 's/^X//' << 'SHAR_EOF' > 'zsh2.2/FEATURES' &&
  137. Xvery close to ksh/sh grammar, with csh additions
  138. Xmost features of ksh, bash, and tcsh
  139. X75 builtins, 73 options, 144 key bindings
  140. Xshort for loops, ex: for i (*.c) echo $i
  141. Xselect
  142. Xshell functions
  143. Xconditional expressions (test builtin, [ ... ], and ksh-style [[ ... ]])
  144. Xglobal aliases (may be expanded anywhere on the line)
  145. Xdirectory stack access with =num
  146. Xprocess substitution (vi =(cmd) edits the output of cmd)
  147. Xgeneralized pipes (ls foo >>(cmd1) 2>>(cmd2) pipes stdout to cmd1
  148. X  and stderr to cmd2)
  149. Xarithmetic expressions
  150. Xadvanced globbing:
  151. X  ls **/file  searches recursively for "file" in subdirectories
  152. X  ls file<20->  matches file20, file30, file100, etc.
  153. X  ls *.(c|pro)  matches *.c and *.pro
  154. X  ls *(R)  matches only world-readable files
  155. X  ls *.c~lex.c  matches all .c files except lex.c
  156. Xnull command shorthands:
  157. X  "< file" is same as "more <file"
  158. X  "> file" is same as "cat >file"
  159. X  ">> file" is same as "cat >>file"
  160. Xksh-style coprocesses
  161. Xautomatic file stream teeing (ls >foo >bar puts output in two places)
  162. Xchpwd() function run every time you change directory (useful for
  163. X  updating the status line)
  164. Xjob control
  165. Xcsh-style history
  166. Xfull vi line editing, including "c2w" and "y$" and such things
  167. Xfull emacs line editing
  168. Xincremental history search
  169. Xmagic-space history
  170. Xspelling correction
  171. Xarray parameters
  172. X$HOSTTYPE, $LINENO, $RANDOM, $SECONDS, $cdpath, $COLUMNS, $fignore,
  173. X  $HISTCHARS, $mailpath
  174. Xwith autocd option, typing a directory name by itself is the same as
  175. X  typing "cd dirname"
  176. Xmenu completion: pressing TAB repeatedly cycles through the possible matches
  177. Xincremental path hashing
  178. Xautomatic process time reporting for commands that run over a certain limit
  179. Xfull tcsh-style prompt substitution
  180. Xutmp login/logout reporting
  181. Xwith histverify option, performing csh-style history expansions causes the
  182. X  input line to be brought up for editing instead of being executed
  183. Xwith sunkeyboardhack option, accidently typed trailing ` characters
  184. X  are removed from the input line (for those of you with Sun keyboards :-) )
  185. Xautoloaded functions (loaded from a file when they are first referenced)
  186. X"cd old new" replaces "old" with "new" in directory string
  187. Xgeneralized argument completion, including:
  188. X  - command name completion
  189. X  - filename and path completion
  190. X  - hostname completion
  191. X  - key binding completion
  192. X  - option completion
  193. X  - variable name completion
  194. X  - user-specified keyword completion
  195. Xprompt on right side of screen
  196. Xdirectory stacks
  197. Xhistory datestamps and execution time records
  198. Xcommand scheduling (like at(1), but in the shell's context)
  199. Xtty mode freezing
  200. Xup to 9 startup files (but you only need 1 or 2)
  201. X8-bit clean
  202. Xwhich -a cmd lists all occurences of "cmd" in the path
  203. SHAR_EOF
  204. chmod 0644 zsh2.2/FEATURES ||
  205. echo 'restore of zsh2.2/FEATURES failed'
  206. Wc_c="`wc -c < 'zsh2.2/FEATURES'`"
  207. test 2684 -eq "$Wc_c" ||
  208.     echo 'zsh2.2/FEATURES: original size 2684, current size' "$Wc_c"
  209. rm -f _shar_wnt_.tmp
  210. fi
  211. # ============= zsh2.2/NOTES ==============
  212. if test -f 'zsh2.2/NOTES' -a X"$1" != X"-c"; then
  213.     echo 'x - skipping zsh2.2/NOTES (File already exists)'
  214.     rm -f _shar_wnt_.tmp
  215. else
  216. > _shar_wnt_.tmp
  217. echo 'x - extracting zsh2.2/NOTES (Text)'
  218. sed 's/^X//' << 'SHAR_EOF' > 'zsh2.2/NOTES' &&
  219. XImportant notes:
  220. X
  221. X1. Stuff like "ls *.sdofij 2>/dev/null" to suppress error messages
  222. X   produced by the shell don't work anymore.  Filename generation is
  223. X   done BEFORE redirection.  To avoid the error message, use the
  224. X   nonomatch option, or do "( ls *.sdofij ) 2>/dev/null".
  225. X
  226. X2. History substitution is no longer done inside startup files.  If you
  227. X   have sequences like \! or !" in your startup files, they will break.
  228. X   (Especially !").  So check for those; remove the !", and change the
  229. X   \! to !.
  230. SHAR_EOF
  231. chmod 0644 zsh2.2/NOTES ||
  232. echo 'restore of zsh2.2/NOTES failed'
  233. Wc_c="`wc -c < 'zsh2.2/NOTES'`"
  234. test 505 -eq "$Wc_c" ||
  235.     echo 'zsh2.2/NOTES: original size 505, current size' "$Wc_c"
  236. rm -f _shar_wnt_.tmp
  237. fi
  238. # ============= zsh2.2/README ==============
  239. if test -f 'zsh2.2/README' -a X"$1" != X"-c"; then
  240.     echo 'x - skipping zsh2.2/README (File already exists)'
  241.     rm -f _shar_wnt_.tmp
  242. else
  243. > _shar_wnt_.tmp
  244. echo 'x - extracting zsh2.2/README (Text)'
  245. sed 's/^X//' << 'SHAR_EOF' > 'zsh2.2/README' &&
  246. XYou have permission to copy the zsh distribution in whole or in part
  247. Xas long as you don't try to make money off of it, or pretend that you
  248. Xwrote it.
  249. X
  250. XThis is zsh 2.2.0.
  251. X
  252. XTo get this shell running, cd into the src directory and type
  253. X"buildzsh".  I tested it on the following machines, where it compiled
  254. Xjust by running this script:
  255. X
  256. XSun SPARCServer 4/690 running SunOS 4.1.2
  257. XNeXTstation running Mach 2.0
  258. XDECStation-5000 running ULTRIX 4.2
  259. XIris 4D/20 running IRIX 4.0.1
  260. XHP 9000/834 running HP-UX 7.00
  261. XIBM RS6000 running AIX 3.2
  262. X(rumored to work on a Pyramid)
  263. X
  264. XIn general, the more BSD-like your system, the more likely it will work.
  265. X
  266. XTabstops are 3 spaces.  If you're going to look at my code, run it
  267. Xthough "expand -3" first, or set your tab stops to the same as mine.
  268. X
  269. XThere is a zsh mailing list, "zsh-list@cs.uow.edu.au".  To have yourself
  270. Xadded to the list, send a request to "zsh-request@cs.uow.edu.au".
  271. X
  272. XThe author can be reached via email to one of the following addresses:
  273. X"pfalstad@phoenix.princeton.edu", "pfalstad@cs.ucsd.edu", "pf@ttisms.com",
  274. X"pf@gnu.ai.mit.edu".
  275. X
  276. XThanks to the following people for help, ideas, accounts, comments,
  277. Xpatches, etc.:
  278. X 
  279. XCharles Hannum
  280. XDavid Dobkin
  281. XJim Mattson
  282. XCarlos Carvalho
  283. XBart Schaefer
  284. XPeter Gray
  285. XPure Software, Inc.
  286. XChris P. Ross
  287. XGary Oberbrunner
  288. XJonathan Hardwick
  289. XJohn Navarra
  290. XMichael Lamoureux
  291. XRick Lyons
  292. XDuncan Sinclair
  293. XMark R. Rubin
  294. XJohn Guthrie
  295. XJames Bonfield
  296. XChris Moore
  297. XThomas Winder
  298. XDavid J. MacKenzie
  299. XCharles Rendleman
  300. XRichard Ohnemus
  301. XNik Gervae
  302. XGottfried Necker
  303. XGoran Larsson
  304. XPaul E. Maisano
  305. XNorbert Kiesel
  306. XJosh Diamond
  307. XBill Miskovetz
  308. XPeter Moore
  309. XGeoff Wing
  310. XKent Dickey
  311. XJean-Jacques Moreau
  312. XMichael Brown
  313. XBruce Anderson
  314. XStephen Dum
  315. XLars E. Thon
  316. XMichael Brennan
  317. XXev Gittler
  318. XJarkko Hietaniemi
  319. XZbigniew J Tyrlik
  320. XPierre Racz
  321. XRick Ohnemus
  322. XRichard Dean
  323. XGary D. Kline
  324. XRobert A. Fabian
  325. XByron Rakitzis
  326. XDan Bernstein
  327. XJonathan Kamens
  328. XVincent Granet
  329. XDavid Wilson
  330. XGreg Noel
  331. XPaul Lew
  332. XDan Esbensen
  333. XKartik Subbarao
  334. XRoss Bunker
  335. XMichael Marucheck
  336. XChristopher Pirazzi
  337. XSteve Giovanetti
  338. XKennedy Lemke
  339. XEmin Gun Sirer
  340. XKazuo Itoh
  341. Xlots of other people, I'm sure
  342. X
  343. XModification history:
  344. X
  345. X2.2.0-2.1.0:
  346. Xo should be faster in general
  347. Xo fewer compilation warnings
  348. Xo SPROMPT now uses %R instead of %s for the incorrect string
  349. Xo no longer tries to create FIFOs on NeXTs (thereby causing a panic)
  350. Xo now gets usernames from NIS on irises without crashing (SGI's getpwnam()
  351. X  called my strdup(), the pricks.  Took me forever to find that.  :-) )
  352. Xo fewer 7-bit assumptions
  353. Xo which/whence/type have new options:
  354. X  -a = all (find all occurences of command in path)
  355. X  -c = csh-style which (default for "which" command)
  356. Xo error message for cd str1 str2 is fixed
  357. Xo relative paths (including .) in cdpath now work
  358. Xo exclusion patterns in glob: ls *.c~lex.c prints all .c files but lex.c
  359. Xo bug with command substitution in chpwd fixed (buffers flushed twice)
  360. Xo relative paths in $path now work
  361. Xo "kill -9 -FOO" no longer kills shell
  362. Xo new options to history/fc:
  363. X    -d = prints date commands were entered
  364. X    -D = prints running time of commands
  365. Xo "history <num>" prints all commands SINCE <num> as well
  366. Xo history stored differently - should be more efficient
  367. Xo bg'ing a suspended zsh no longer causes problems
  368. Xo "set" no longer prints ONLY exported params (duh)
  369. Xo functions +t now allowed
  370. Xo redirection is done AFTER filename generation
  371. Xo print changes:
  372. X  o print -u# prints to fd #
  373. X  o print -p prints to coproc
  374. X  o -D and -P perform \ substitution first
  375. X  o print -0 changed to print -N
  376. Xo read changes:
  377. X  o read -u# reads from fd #
  378. X  o read -p reads from coproc
  379. X  o read -z waits for input if nothing on buffer stack
  380. X  o no longer reads from fd 0 if shell is getting input from there
  381. X  o echo -n foo | read x  now works
  382. Xo getopts is now POSIX conformant
  383. Xo compctl builtin added, replacing hostcmds, foocmds, etc.  Controls
  384. X  completion of various commands in zle.
  385. X  format: compctl -options cmdnams ...
  386. X  options tell where to get possible matches from, and include:
  387. X     -c = command names
  388. X     -f = filenames
  389. X     -h = hostnames ($hosts)
  390. X     -o = options
  391. X     -v = vars
  392. X     -b = bindings
  393. X     -k name = elements of $name array
  394. X  Any number of these options may be used together.
  395. X  In addition, compctl -C -options will set the default completion
  396. X  names when in command position (by default -c), and compctl -D -options
  397. X  will set the default completion names used after unrecognized commands
  398. X  or after redirections (by default -f).
  399. Xo foo && bar || fuu now works
  400. Xo ttyctl builtin added
  401. X  ttyctl -f freezes the tty.  no changes made to the tty settings by
  402. X     external programs will be honored when this command is in effect.
  403. X  ttyctl -u unfreezes the tty.
  404. X  typically, "ttyctl -f" would be used in a zlogin or zshrc script after
  405. X  "stty" has been called to set up the terminal.
  406. Xo [[ -e file ]] is now equivalent to [[ -a file ]]
  407. Xo [[ -h file ]] is now equivalent to [[ -L file ]]
  408. Xo the path is now hashed incrementally.
  409. X  o if the HASHCMDS option is unset, path hashing is not done at all.
  410. X  o if the HASHCMDS option is set but HASHDIRS is unset, commands are placed
  411. X     in the hash table when first executed.
  412. X  o if the HASHCMDS and HASHDIRS options are both set, commands are placed
  413. X     in the hash table when first executed, along with all commands in
  414. X     the directory that command was found in (and all directories earlier
  415. X     in the path).  This is the default situation.
  416. Xo "for i (*.c) do /bin/echo $i ; done | more" no longer hangs
  417. Xo coprocesses now work properly
  418. Xo READNULLCMD is now used instead of NULLCMD for "< file"
  419. Xo POSTEDIT is printed whenever the editor exits
  420. Xo rm path/path/* is now reported by checkrmall()
  421. Xo cmd >&- works
  422. Xo cmd >>! file works
  423. Xo time cmd no longer forks an extra process
  424. Xo setopt printexitvalue ; echo `false` no longer prints anything
  425. Xo here documents work inside eval, etc.
  426. Xo $(...) works inside here documents
  427. Xo "time" by itself prints the shell timings
  428. Xo locals in precmd() or chpwd() work
  429. Xo new glob qualifiers
  430. X  o pat(M) sets markdirs, pat(^M) unsets it
  431. X  o pat(N) sets nullglob, ...
  432. X  o pat(D) sets globdots, ...
  433. Xo ls * only sorts numeric filenames specially if NUMERICGLOBSORT is set
  434. Xo setopt braceccl lets "echo {a-zA-Z}" work
  435. Xo new options: pushdignoredups nohistbeep overstrike
  436. Xo ls **/file is now equivalent to ls ****/file
  437. Xo !'s in history are now escaped when you return to them
  438. Xo history substitution is not done in script files
  439. Xo echo $(!-2) works
  440. Xo histverify and correct 'e' no longer put the edit line in the history
  441. Xo the :x, :q, and :gs modifiers work properly now
  442. Xo zsh -c 'ls =(ls)' no longer hangs
  443. Xo VSWTCH is now set to ^Z on the irises
  444. Xo zsh & no longer causes havoc
  445. Xo USERNAME and LOGNAME are kept separate
  446. Xo $manpath has been added for easy access to the $MANPATH components
  447. Xo zsh now realizes if it is running under emacs, and resigns itself to
  448. X  the fact rather than panicking
  449. Xo SIGQUIT is ignored in the PRODUCTION version of zsh, and kills the shell
  450. X  in the DEBUG version, rather than vice versa.
  451. Xo GLOBALZSHENV has been added, and GLOBALZPROFILE is sourced in the
  452. X  proper place
  453. Xo "kill %" no longer causes the prompt to be printed 3 times if notify
  454. X  is set on a NeXT
  455. Xo REPORTTIME has been added; if a job runs longer than this many seconds,
  456. X  timing statistics are reported
  457. Xo timing statistics now include a job name (%J)
  458. Xo no longer talks about SIGHUPed jobs if the kill failed
  459. Xo no longer talks about running jobs which don't exist if you do eval exit
  460. X  or if you have notify unset
  461. Xo foo=bar comman[tab], for/select/foreach i (*.c[tab] both work
  462. Xo [base]num inside $[...] works
  463. Xo foo=pat(n|ern) works
  464. Xo cd - prints the new directory
  465. Xo l[tab] works if l is an alias
  466. Xo select foo ; ... works (in $argv is assumed)
  467. Xo select reads from the right input
  468. Xo math identifiers can now contain numbers and _'s.
  469. Xo lots of serious memory heap trashing and leaks fixed
  470. Xo echo $HOME[*] no longer crashes the shell
  471. Xo SIGWINCH now changes LINES and COLUMNS in the environment
  472. Xo typeset +r TTY; TTY=foo no longer causes problems
  473. Xo ~ substitution is no longer done in FIGNORE
  474. Xo assignment to SECONDS works
  475. Xo "else if" is no longer a synonym for "elif" <thud>
  476. Xo lots of problems with null lists in flow constructs fixed
  477. Xo no correction done for >file
  478. Xo echo ${foo%bar is no longer weird
  479. Xo modifying array substitutions works
  480. Xo ^O can be bound to something
  481. Xo command substitution in signal handlers no longer causes problems
  482. Xo spelling correction is better ($PAHT is corrected), and SPROMPT
  483. X  allows all the regular PROMPT escapes
  484. Xo new prompt escape sequence: %D{...} formats ... part using strftime
  485. Xo shell input no longer butchered using IFS
  486. Xo vi cmd mode has 's' bound to visubstitute, as it should be
  487. Xo you can use ^XS and ^XR in i-search mode
  488. Xo bindings to ^Z and ^@ work now on the irises
  489. Xo ^V{^S,^Q,^Z,etc} now works on sgttyb victims
  490. Xo nopromptclobber changed to nopromptcr
  491. Xo vi 'u' undo works a little better (?)
  492. Xo ESC-key bindings aren't screwed up if VISUAL is set to vi
  493. Xo newline in prompt now works reliably
  494. Xo vi change and delete work with forward-word/search, etc.
  495. Xo somewhat suboptimal screen refresh on irises fixed (several seconds
  496. X  per character inserted when TERM=xterm??)
  497. Xo select list printing slightly different
  498. Xo magic-space's handling of hatchars "fixed"
  499. X
  500. X0.03-1.0:
  501. X    - "..../" is now "****/".  I know this isn't backward compatible,
  502. X      but I had no choice; the string "..../" was unquotable.
  503. X    - parser was rewritten and improved
  504. X    - completion was improved, several bugs fixed (including
  505. X      the "$([tab]" bug)
  506. X    - vi mode editing is improved
  507. X    - the value of PWD and OLDPWD in the environment now change
  508. X    - the PROMPT formatting strings %W and %D now print the month
  509. X      correctly
  510. X    - >&2 echo "error message" no longer prints "bad file number"
  511. X    - ${foo%pat} no longer alters the value of foo
  512. X    - $_ works
  513. X    - ALL_EXPORT no longer causes let statements to crash the shell
  514. X    - continue works
  515. X    - echo $MAIL no longer dumps core if MAIL is null
  516. X    - the new tty driver is selected by default
  517. X    - the s modifier no longer complains if it can't find the string
  518. X      to substitute
  519. X    - list-choices no longer fignores files
  520. X    - cd is now smarter about symlinks
  521. X    - negative subscripts other than -1 now work
  522. X    - $(<filename) works better if filename contains $, ~, or =
  523. X    - rehash no longer wastes memory
  524. X    - with name=value assignments, name is checked to see if it is
  525. X      a valid identifier
  526. X    - !1; !2 no longer eats the semicolon
  527. X    - $foo:h never returns the empty string if foo starts with /
  528. X    - select crashed with some compilers
  529. X    - problems with aliases in <(...) constructs have been fixed
  530. X    - links pointing to nowhere are denoted with an '&' in listtypes
  531. X    - negative arguments are supported
  532. X    - the shell does not screw around with the tty so much
  533. X    - lots of other stuff
  534. X
  535. X0.02-0.03:
  536. X    - two stupid bugs that were introduced in the last patch were fixed:
  537. X      - multiple command substitution on a line failed
  538. X      - a file descriptor leak caused the shell to crash after a while
  539. X    - added 'An Introduction to the Z Shell'
  540. X    - behaves properly when the tty session dies suddenly
  541. X    - had a serious memory leak on some systems
  542. X    - the test and [ builtins have been added, although [[...]]
  543. X      is more efficient
  544. X    - in your prompt, %m2 now prints foo.bar, %m3 prints foo.bar.com, etc.
  545. X    - the -D and -P options to print have been added
  546. X    - the NULLCMD and ZDOTDIR parameters have been added
  547. X    - ${*:-foo} works
  548. X    - "$@" and "$arr[@]" work like ksh
  549. X    - .zprofile is sourced before .zshrc in login shells
  550. X    - the CSHJUNKIEQUOTES and PUSHDMINUS options have been added
  551. X    - REAL_TTY compilation switch added
  552. X    - aliases beginning with a space cause the history line to be junked
  553. X      if HISTIGNORESPACE is set
  554. X    - echo prints bad options instead of complaining about them
  555. X    - "set -o" no longer dumps core
  556. X    - "alias a=alias; date >a" no longer creates a file called "alias"
  557. X    - "function foo() \n { date }" is now legal (the () and the newline
  558. X      are allowed)
  559. X    - nested brace expressions work properly
  560. X    - disabled commands stay disabled after a rehash (or after the shell
  561. X      finishes sourcing your .zshrc)
  562. X    - corrected aliases work
  563. X    - executables in the currect directory are now completed
  564. X    - in "case foo", "foo" is not interpreted as a directory name with autocd
  565. X    - aliases were not always interpreted properly after a completion
  566. X    - bindkey '^?' didn't work
  567. X    - echo ${HOST:-{bar}} didn't work
  568. X    - editor update is more efficient in some cases
  569. X    - menucomplete works even better
  570. X    - assign to an array element "foo[1]=bar" didn't always work
  571. X    - doesn't print directories like "~tmp" if HOME=/
  572. X    - quotes in case statement patterns caused problems
  573. X    - pressing ^C right after typing "fc" caused the editor to share
  574. X      the tty with the shell
  575. X    - echo $(echo 2) produced no output, but echo $(echo x) worked fine (weird)
  576. X
  577. X0.01-0.02:
  578. X    - added script to convert most csh aliases to zsh aliases or functions
  579. X    - fc -l (history) now appears in the history itself; HISTNOSTORE
  580. X      option added to get old behavior
  581. X    - the POSIX process group race has been fixed; so 'w | more' should
  582. X      no longer hang
  583. X    - FCEDIT added, to match the documentation
  584. X    - %{...%} in the prompt added
  585. X    - execute-named-cmd and execute-last-named-cmd bindings added
  586. X    - sources ~/.zshenv in all shells, even if not interactive, unless
  587. X      -f is given
  588. X    - ^ and # are no longer `magic' by default; use EXTENDEDGLOB option
  589. X      to use them
  590. X    - now checks for tty sanity before each command
  591. X    - if the right side of a variable assignment expands to more than
  592. X      one word, array assignment is assumed; so foo=*.c now works
  593. X    - ~foo is no longer expanded in completion
  594. X    - select now works even if the argument list is not sorted
  595. X    - menucompletebeep option added
  596. X    - emacs mode is now 8-bit clean by default; use bindkey -em
  597. X      to get your meta key back
  598. X    - fc -R, fc -W added
  599. X    - nocorrect added
  600. X    - lines from history file are now split into words at spaces
  601. X    - glob-complete, accept-and-menu-complete,
  602. X      beginning-of-line-hist, end-of-line-hist bindings added
  603. X    - insert-last-word bound to M-. in emacs mode by default; now moves
  604. X      back through the history if run repeatedly
  605. X    - J and K now bound to history search in vi mode
  606. X    - delete-char no longer core dumps on an empty line
  607. X    - menu-complete works better
  608. X    - the editor checks the settings of VISUAL and EDITOR to set
  609. X      default bindings
  610. X    - using [[ ... ]] expressions on a symbolic link works as expected
  611. X    - various problems with globbing were fixed
  612. X    - xx is now the same as !! if HISTCHARS=x
  613. X    - added config.h entry for compilers that don't know about void *
  614. X    - lexical analysis made more efficient
  615. X    - "if echo $? ; then : ; fi" no longer always prints 0
  616. X    - removed all enums, '\x7f's from code
  617. X    - in "case foo in bar) xxx ;; esac", foo and bar are no longer subject
  618. X      to command alias expansion
  619. X    - works on platforms where toupper('A') != 'A'
  620. X    - \e sequence added to echo
  621. X    - + options now work with set
  622. X    - AUTORESUME and AUTOCD work better
  623. X    - getopts works better (?)
  624. X    - spell checking works better
  625. X    - "let 2+3=" no longer crashes the shell
  626. X    - "foo=bar; echo ${=foo}" no longer crashes the shell
  627. X    - "zsh -c" or "zsh -o" no longer causes a core dump
  628. X    - "unset MAIL; echo $MAIL" no longer causes a core dump
  629. X    - "(xterm&xterm&)&" no longer causes a core dump
  630. X    - "echo $HOM[tab]" beeps instead of deleting "$HOM"
  631. X    - incremental history search works better
  632. X    - the pwd of a fg'd job is now printed _before_ resuming it
  633. X    - rv=`echo -n foo` no longer puts garbage in $rv
  634. X    - "=1/*" now works as expected
  635. X    - ^Z can now be bound to something
  636. X    - the STTY parameter and the builtin builtin are now documented
  637. X    - IFS=x; foo=`echo foo` no longer puts a newline in $foo
  638. X    - $status added for csh compatibility
  639. X    - arrays are automatically expanded if you say 'foo[1234]=x'
  640. X    - shell now ignores SIGQUIT (it was commented out before :-)
  641. X    - the times builtin works on systems where times() returns > 0
  642. X    - no longer hangs the terminal if you ^S before flow control
  643. X      is turned off
  644. X    - "date ; read foo" now works in interactive shells
  645. X    - <<-foo is now parsed as <<- foo, not << -foo
  646. X    - fixed various errors in the documentation
  647. X
  648. X0.00-0.01:
  649. X    - %M and %m now work as documented.
  650. X    - bad things no longer happen if COLUMNS is set to 0
  651. X    - SH_WORD_SPLIT and ${=foo} now work
  652. X    - the default value of WORDCHARS includes more characters
  653. X    - if the cursor is at the end of the line, vi-cmd-mode
  654. X      moves it back one position.
  655. X    - delete-char now acts more like x in vi.
  656. X    - a "prompt" parameter has been added, which is equivalent to
  657. X      PROMPT and PS1.
  658. X    - zsh no longer expands symbolic links.  The CHASELINKS option
  659. X      has been provided to get the old behavior.
  660. X    - history searches ignore lines that are the same as the line
  661. X      in the buffer.
  662. X    - you can get a literal ! in your prompt now with \!.
  663. X    - -z, -n, and != in [[ ... ]] expressions work.
  664. X    - the shell no longer hangs when inputting "[[ ]\n"
  665. X    - the "menu-complete" and "menu-expand-or-complete" bindings have
  666. X      been added.
  667. X    - menu-complete no longer beeps.
  668. X    - reverse-menu-complete no longer dumps core if it gets called before
  669. X      a normal completion.
  670. X    - typeahead lines are no longer thrown away on machines with sgttyb.
  671. X    - !foo no longer matches lines with 'foo' in them (not at the beginning)
  672. X    - kill -9 % no longer kills the shell
  673. X    - no longer sources .zshrc from shell scripts or with -c
  674. X    - no longer needs limits.h, strtol
  675. X    - exporting HOSTTYPE, etc. works
  676. X    - fixed serious bugs related to . in path
  677. X    - numbers in weird bases now work
  678. X
  679. XKnown Bugs
  680. X    - terminal acts weird under OpenWindows cmdtool
  681. X    - xterm run in background inherits bad terminal modes
  682. X
  683. SHAR_EOF
  684. chmod 0644 zsh2.2/README ||
  685. echo 'restore of zsh2.2/README failed'
  686. Wc_c="`wc -c < 'zsh2.2/README'`"
  687. test 17490 -eq "$Wc_c" ||
  688.     echo 'zsh2.2/README: original size 17490, current size' "$Wc_c"
  689. rm -f _shar_wnt_.tmp
  690. fi
  691. # ============= zsh2.2/doc/intro.txt ==============
  692. if test ! -d 'zsh2.2/doc'; then
  693.     echo 'x - creating directory zsh2.2/doc'
  694.     mkdir 'zsh2.2/doc'
  695. fi
  696. if test -f 'zsh2.2/doc/intro.txt' -a X"$1" != X"-c"; then
  697.     echo 'x - skipping zsh2.2/doc/intro.txt (File already exists)'
  698.     rm -f _shar_wnt_.tmp
  699. else
  700. > _shar_wnt_.tmp
  701. echo 'x - extracting zsh2.2/doc/intro.txt (Text)'
  702. sed 's/^X//' << 'SHAR_EOF' > 'zsh2.2/doc/intro.txt' &&
  703. X
  704. X
  705. X
  706. X
  707. X
  708. X
  709. X               An Introduction to the Z Shell
  710. X
  711. X
  712. X                        Paul Falstad
  713. X               pfalstad@phoenix.princeton.edu
  714. X
  715. X
  716. X
  717. X
  718. X
  719. X
  720. Xzsh is a shell designed for interactive use, although it  is
  721. Xalso  a  powerful  scripting  language.   Many of the useful
  722. Xfeatures of bash, ksh, and tcsh were incorporated into  zsh;
  723. Xmany  original  features  were added.  This document details
  724. Xsome of the  unique  features  of  zsh.   It  assumes  basic
  725. Xknowledge of the standard UNIX shells; the intent is to show
  726. Xa reader already familiar with one of the other major shells
  727. Xwhat  makes zsh more useful or more powerful.  This document
  728. Xis not at all comprehensive; read the  manual  entry  for  a
  729. Xdescription  of  the  shell  that  is  complete and concise,
  730. Xalthough somewhat overwhelming and devoid of examples.
  731. X
  732. XFilename Generation
  733. X
  734. XOtherwise known as globbing, filename  generation  is  quite
  735. Xextensive in zsh.  Of course, it has all the basics:
  736. X
  737. X% ls
  738. XMakefile   file.pro   foo.o      main.o     q.c        run234     stuff
  739. Xbar.o      foo        link       morestuff  run123     run240     sub
  740. Xfile.h     foo.c      main.h     pipe       run2       run303
  741. X% ls *.c
  742. Xfoo.c  q.c
  743. X% ls *.[co]
  744. Xbar.o   foo.c   foo.o   main.o  q.c
  745. X% ls foo.?
  746. Xfoo.c  foo.o
  747. X% ls *.[^c]
  748. Xbar.o   file.h  foo.o   main.h  main.o
  749. X% ls *.[^oh]
  750. Xfoo.c  q.c
  751. X
  752. X
  753. XAlso, if the EXTENDEDGLOB option is set, some  new  features
  754. Xare  activated.   For  example,  the ^ character negates the
  755. Xpattern following it:
  756. X
  757. X
  758. X
  759. X
  760. X
  761. X
  762. X
  763. X
  764. X
  765. X
  766. X
  767. X
  768. X
  769. X
  770. X
  771. X                           - 2 -
  772. X
  773. X% setopt extendedglob
  774. X% ls -d ^*.c
  775. XMakefile   file.pro   link       morestuff  run2       run303
  776. Xbar.o      foo        main.h     pipe       run234     stuff
  777. Xfile.h     foo.o      main.o     run123     run240     sub
  778. X% ls -d ^*.*
  779. XMakefile   link       pipe       run2       run240     stuff
  780. Xfoo        morestuff  run123     run234     run303     sub
  781. X% ls -d ^Makefile
  782. Xbar.o      foo        link       morestuff  run123     run240     sub
  783. Xfile.h     foo.c      main.h     pipe       run2       run303
  784. Xfile.pro   foo.o      main.o     q.c        run234     stuff
  785. X% ls -d *.^c
  786. X.rhosts   bar.o     file.h    file.pro  foo.o     main.h    main.o
  787. X
  788. X
  789. XAn expression of the form <x-y> matches a range of integers:
  790. X
  791. X% ls run<200-300>
  792. Xrun234  run240
  793. X% ls run<300-400>
  794. Xrun303
  795. X% ls run<-200>
  796. Xrun123  run2
  797. X% ls run<300->
  798. Xrun303
  799. X% ls run<>
  800. Xrun123  run2    run234  run240  run303
  801. X
  802. X
  803. XGrouping is possible:
  804. X
  805. X% ls (foo|bar).*
  806. Xbar.o  foo.c  foo.o
  807. X% ls *.(c|o|pro)
  808. Xbar.o     file.pro  foo.c     foo.o     main.o    q.c
  809. X
  810. X
  811. XAlso, the string ****/ forces a  recursive  search  of  sub-
  812. Xdirectories:
  813. X
  814. X
  815. X
  816. X
  817. X
  818. X
  819. X
  820. X
  821. X
  822. X
  823. X
  824. X
  825. X
  826. X
  827. X
  828. X
  829. X
  830. X
  831. X
  832. X
  833. X
  834. X
  835. X
  836. X
  837. X                           - 3 -
  838. X
  839. X% ls -R
  840. XMakefile   file.pro   foo.o      main.o     q.c        run234     stuff
  841. Xbar.o      foo        link       morestuff  run123     run240     sub
  842. Xfile.h     foo.c      main.h     pipe       run2       run303
  843. X
  844. Xmorestuff:
  845. X
  846. Xstuff:
  847. Xfile  xxx   yyy
  848. X
  849. Xstuff/xxx:
  850. Xfoobar
  851. X
  852. Xstuff/yyy:
  853. Xfrobar
  854. X% ls ****/*bar
  855. Xstuff/xxx/foobar  stuff/yyy/frobar
  856. X% ls ****/f*
  857. Xfile.h            foo               foo.o             stuff/xxx/foobar
  858. Xfile.pro          foo.c             stuff/file        stuff/yyy/frobar
  859. X% ls *bar*
  860. Xbar.o
  861. X% ls ****/*bar*
  862. Xbar.o             stuff/xxx/foobar  stuff/yyy/frobar
  863. X% ls stuff/****/*bar*
  864. Xstuff/xxx/foobar  stuff/yyy/frobar
  865. X
  866. X
  867. X
  868. XIt is possible to exclude certain files  from  the  patterns
  869. Xusing  the  ~  character.   A  pattern of the form *.c~bar.c
  870. Xlists all files matching *.c, except for the file bar.c.
  871. X
  872. X% ls *.c
  873. Xfoo.c    foob.c    bar.c
  874. X% ls *.c~bar.c
  875. Xfoo.c    foob.c
  876. X% ls *.c~f*
  877. Xbar.c
  878. X
  879. X
  880. X
  881. XOne can add a number of qualifiers to  the  end  of  any  of
  882. Xthese  patterns,  to restrict matches to certain file types.
  883. XA qualified pattern is of the form
  884. X
  885. X        pattern(...)
  886. X
  887. X
  888. Xwith single-letter qualifiers inside the parentheses.
  889. X
  890. X
  891. X
  892. X
  893. X
  894. X
  895. X
  896. X
  897. X
  898. X
  899. X
  900. X
  901. X
  902. X
  903. X                           - 4 -
  904. X
  905. X% alias l='ls -dF'
  906. X% l *
  907. XMakefile    foo*        main.h      q.c         run240
  908. Xbar.o       foo.c       main.o      run123      run303
  909. Xfile.h      foo.o       morestuff/  run2        stuff/
  910. Xfile.pro    link@       pipe        run234      sub
  911. X% l *(/)
  912. Xmorestuff/  stuff/
  913. X% l *(@)
  914. Xlink@
  915. X% l *(*)
  916. Xfoo*        link@       morestuff/  stuff/
  917. X% l *(x)
  918. Xfoo*        link@       morestuff/  stuff/
  919. X% l *(X)
  920. Xfoo*        link@       morestuff/  stuff/
  921. X% l *(R)
  922. Xbar.o       foo*        link@       morestuff/  run123      run240
  923. Xfile.h      foo.c       main.h      pipe        run2        run303
  924. Xfile.pro    foo.o       main.o      q.c         run234      stuff/
  925. X
  926. X
  927. XNote that  *(x)  and  *(*)  both  match  executables.   *(X)
  928. Xmatches  files  executable  by  others,  as opposed to *(x),
  929. Xwhich matches files executable by the owner.  *(R) and  *(r)
  930. Xmatch  readable files; *(W) and *(w), which checks for writ-
  931. Xable files.  *(W) is especially important, since  it  checks
  932. Xfor world-writable files:
  933. X
  934. X% l *(w)
  935. Xbar.o       foo*        link@       morestuff/  run123      run240
  936. Xfile.h      foo.c       main.h      pipe        run2        run303
  937. Xfile.pro    foo.o       main.o      q.c         run234      stuff/
  938. X% l *(W)
  939. Xlink@   run240
  940. X% l -l link run240
  941. Xlrwxrwxrwx  1 pfalstad       10 May 23 18:12 link -> /bin/false*
  942. X-rw-rw-rw-  1 pfalstad        0 May 23 18:12 run240
  943. X
  944. X
  945. XYou can filter out the symbolic links with the ^ character:
  946. X
  947. X% l *(W^@)
  948. Xrun240
  949. X% l *(x)
  950. Xfoo*        link@       morestuff/  stuff/
  951. X% l *(x^@/)
  952. Xfoo*
  953. X
  954. X
  955. XTo find all plain files, you can use .:
  956. X
  957. X
  958. X
  959. X
  960. X
  961. X
  962. X
  963. X
  964. X
  965. X
  966. X
  967. X
  968. X
  969. X                           - 5 -
  970. X
  971. X% l *(.)
  972. XMakefile  file.h    foo*      foo.o     main.o    run123    run234    run303
  973. Xbar.o     file.pro  foo.c     main.h    q.c       run2      run240    sub
  974. X% l *(^.)
  975. Xlink@       morestuff/  pipe        stuff/
  976. X% l s*(.)
  977. Xstuff/   sub
  978. X% l *(p)
  979. Xpipe
  980. X% l -l *(p)
  981. Xprw-r--r--  1 pfalstad        0 May 23 18:12 pipe
  982. X
  983. X
  984. X*(U) matches all files owned by  you.   To  search  for  all
  985. Xfiles not owned by you, use *(^U):
  986. X
  987. X% l -l *(^U)
  988. X-rw-------  1 subbarao       29 May 23 18:13 sub
  989. X
  990. X
  991. XThis searches for setuid files:
  992. X
  993. X% l -l *(s)
  994. X-rwsr-xr-x  1 pfalstad       16 May 23 18:12 foo*
  995. X
  996. X
  997. XThis checks for a certain user's files:
  998. X
  999. X% ypmatch subbarao passwd
  1000. Xsubbarao:*:3338:35:Kartik Subbarao:/u/subbarao:/usr/princeton/bin/zsh
  1001. X% l -l *(u3338)
  1002. X-rw-------  1 subbarao       29 May 23 18:13 sub
  1003. X
  1004. X
  1005. X
  1006. XStartup Files
  1007. X
  1008. XThere are five startup files that  zsh  will  read  commands
  1009. Xfrom:
  1010. X
  1011. X$ZDOTDIR/.zshenv
  1012. X$ZDOTDIR/.zprofile
  1013. X$ZDOTDIR/.zshrc
  1014. X$ZDOTDIR/.zlogin
  1015. X$ZDOTDIR/.zlogout
  1016. X
  1017. X
  1018. XIf ZDOTDIR is not set, then the value of HOME is used;  this
  1019. Xis the usual case.
  1020. X
  1021. X.zshenv is sourced on all invocations of the  shell,  unless
  1022. Xthe -f option is set.  It should contain commands to set the
  1023. Xcommand search path, plus other important environment  vari-
  1024. Xables.   .zshenv  should  not  contain commands that produce
  1025. Xoutput or assume the shell is attached to a tty.
  1026. X
  1027. X.zshrc is sourced in interactive shells.  It should  contain
  1028. Xcommands  to  set  up aliases, functions, options, key bind-
  1029. Xings, etc.
  1030. X
  1031. X
  1032. X
  1033. X
  1034. X
  1035. X                           - 6 -
  1036. X.zlogin is sourced in login shells.  It should contain  com-
  1037. Xmands  that  should be executed only in login shells.  .zlo-
  1038. Xgout is sourced when login shells exit.  .zprofile is  simi-
  1039. Xlar  to  .zlogin,  except  that it is sourced before .zshrc.
  1040. X.zprofile is meant as an  alternative  to  .zlogin  for  ksh
  1041. Xfans; the two are not intended to be used together, although
  1042. Xthis could certainly be done if desired.  .zlogin is not the
  1043. Xplace  for  alias definitions, options, environment variable
  1044. Xsettings, etc.; as a general rule, it should not change  the
  1045. Xshell  environment at all.  Rather, it should be used to set
  1046. Xthe terminal type and run  a  series  of  external  commands
  1047. X(fortune, msgs, etc).
  1048. X
  1049. XShell Functions
  1050. X
  1051. Xzsh also allows you to create your own commands by  defining
  1052. Xshell functions.  For example:
  1053. X
  1054. X% yp () {
  1055. X>       ypmatch $1 passwd.byname
  1056. X> }
  1057. X% yp pfalstad
  1058. Xpfalstad:*:3564:35:Paul John Falstad:/u/pfalstad:/usr/princeton/bin/zsh
  1059. X
  1060. X
  1061. XThis function looks up a user in the NIS password map.   The
  1062. X$1  expands to the first argument to yp.  The function could
  1063. Xhave been equivalently defined in one of the following ways:
  1064. X
  1065. X% function yp {
  1066. X>       ypmatch $1 passwd.byname
  1067. X> }
  1068. X% function yp () {
  1069. X>       ypmatch $1 passwd.byname
  1070. X> }
  1071. X% function yp () ypmatch $1 passwd.byname
  1072. X
  1073. X
  1074. XNote that aliases are expanded when the function  definition
  1075. Xis parsed, not when the function is executed.  For example:
  1076. X
  1077. X% alias ypmatch=echo
  1078. X% yp pfalstad
  1079. Xpfalstad:*:3564:35:Paul John Falstad:/u/pfalstad:/usr/princeton/bin/zsh
  1080. X
  1081. X
  1082. XSince the alias was defined after the function  was  parsed,
  1083. Xit  has  no effect on the function's execution.  However, if
  1084. Xwe define the function again with the alias in place:
  1085. X
  1086. X% function yp () { ypmatch $1 passwd.byname }
  1087. X% yp pfalstad
  1088. Xpfalstad passwd.byname
  1089. X
  1090. X
  1091. Xit is parsed with the new alias definition in place.  There-
  1092. Xfore, in general you must define aliases before functions.
  1093. X
  1094. XWe can make the function take multiple arguments:
  1095. X
  1096. X
  1097. X
  1098. X
  1099. X
  1100. X
  1101. X                           - 7 -
  1102. X
  1103. X% unalias ypmatch
  1104. X% yp () {
  1105. X>       for i
  1106. X>       do ypmatch $i passwd.byname
  1107. X>       done
  1108. X> }
  1109. X% yp pfalstad subbarao sukthnkr
  1110. Xpfalstad:*:3564:35:Paul John Falstad:/u/pfalstad:/usr/princeton/bin/zsh
  1111. Xsubbarao:*:3338:35:Kartik Subbarao:/u/subbarao:/usr/princeton/bin/zsh
  1112. Xsukthnkr:*:1267:35:Rahul Sukthankar:/u/sukthnkr:/usr/princeton/bin/tcsh
  1113. X
  1114. X
  1115. XThe for i loops through each of  the  function's  arguments,
  1116. Xsetting  i  equal to each of them in turn.  We can also make
  1117. Xthe function do  something  sensible  if  no  arguments  are
  1118. Xgiven:
  1119. X
  1120. X% yp () {
  1121. X>       if (( $# == 0 ))
  1122. X>       then echo usage: yp name ...; fi
  1123. X>       for i; do ypmatch $i passwd.byname; done
  1124. X> }
  1125. X% yp
  1126. Xusage: yp name ...
  1127. X% yp pfalstad sukthnkr
  1128. Xpfalstad:*:3564:35:Paul John Falstad:/u/pfalstad:/usr/princeton/bin/zsh
  1129. Xsukthnkr:*:1267:35:Rahul Sukthankar:/u/sukthnkr:/usr/princeton/bin/tcsh
  1130. X
  1131. X
  1132. X$# is the number of arguments supplied to the function.   If
  1133. Xit is equal to zero, we print a usage message; otherwise, we
  1134. Xloop through the arguments, and ypmatch all of them.
  1135. X
  1136. XHere's a function that selects a random line from a file:
  1137. X
  1138. X% randline () {
  1139. X>       integer z=$(wc -l <$1)
  1140. X>       sed -n $[RANDOM % z + 1]p $1
  1141. X> }
  1142. X% randline /etc/motd
  1143. XPHOENIX WILL BE DOWN briefly Friday morning, 5/24/91 from 8 AM to
  1144. X% randline /etc/motd
  1145. XSunOS Release 4.1.1 (PHOENIX) #19: Tue May 14 19:03:15 EDT 1991
  1146. X% randline /etc/motd
  1147. X| Please use the "msgs" command to read announcements.  Refer to the   |
  1148. X% echo $z
  1149. X
  1150. X%
  1151. X
  1152. X
  1153. Xrandline has a local variable, z, that holds the  number  of
  1154. Xlines  in  the  file.  $[RANDOM % z + 1] expands to a random
  1155. Xnumber between 1 and z.  An expression of  the  form  $[...]
  1156. Xexpands to the value of the arithmetic expression within the
  1157. Xbrackets, and the RANDOM variable returns  a  random  number
  1158. Xeach  time  it is referenced.  % is the modulus operator, as
  1159. Xin C.  Therefore, sed -n $[RANDOM%z+1]p picks a random  line
  1160. Xfrom its input, from 1 to z.
  1161. X
  1162. X
  1163. X
  1164. X
  1165. X
  1166. X
  1167. X                           - 8 -
  1168. XFunction definitions can be viewed with the functions  buil-
  1169. Xtin:
  1170. X
  1171. X% functions randline
  1172. Xrandline () {
  1173. X        integer z=$(wc -l <$1)
  1174. X        sed -n $[RANDOM % z + 1]p $1
  1175. X
  1176. X}
  1177. X% functions
  1178. Xyp () {
  1179. X        if let $# == 0
  1180. X
  1181. X        then
  1182. X                echo usage: yp name ...
  1183. X
  1184. X        fi
  1185. X        for i
  1186. X        do
  1187. X                ypmatch $i passwd.byname
  1188. X
  1189. X                done
  1190. X
  1191. X}
  1192. Xrandline () {
  1193. X        integer z=$(wc -l <$1)
  1194. X        sed -n $[RANDOM % z + 1]p $1
  1195. X
  1196. X}
  1197. X
  1198. X
  1199. XHere's another one:
  1200. X
  1201. X% cx () { chmod +x $* }
  1202. X% ls -l foo bar
  1203. X-rw-r--r--  1 pfalstad       29 May 24 04:38 bar
  1204. X-rw-r--r--  1 pfalstad       29 May 24 04:38 foo
  1205. X% cx foo bar
  1206. X% ls -l foo bar
  1207. X-rwxr-xr-x  1 pfalstad       29 May 24 04:38 bar
  1208. X-rwxr-xr-x  1 pfalstad       29 May 24 04:38 foo
  1209. X
  1210. X
  1211. XNote that this could also have been implemented as an alias:
  1212. X
  1213. X% chmod 644 foo bar
  1214. X% alias cx='chmod +x'
  1215. X% cx foo bar
  1216. X% ls -l foo bar
  1217. X-rwxr-xr-x  1 pfalstad       29 May 24 04:38 bar
  1218. X-rwxr-xr-x  1 pfalstad       29 May 24 04:38 foo
  1219. X
  1220. X
  1221. X
  1222. XInstead of defining a lot of functions in your  .zshrc,  all
  1223. Xof  which  you  may  not  use, it is often better to use the
  1224. Xautoload builtin.  The idea is, you create a directory where
  1225. Xfunction  definitions  are stored, declare the names in your
  1226. X.zshrc, and tell the shell where to look for them.  Whenever
  1227. Xyou  reference a function, the shell will automatically load
  1228. X
  1229. X
  1230. X
  1231. X
  1232. X
  1233. X                           - 9 -
  1234. Xit into memory.
  1235. X
  1236. X% mkdir /tmp/funs
  1237. X% cat >/tmp/funs/yp
  1238. Xypmatch $1 passwd.byname
  1239. X^D
  1240. X% cat >/tmp/funs/cx
  1241. Xchmod +x $*
  1242. X^D
  1243. X% FPATH=/tmp/funs
  1244. X% autoload cx yp
  1245. X% functions cx yp
  1246. Xundefined cx ()
  1247. Xundefined yp ()
  1248. X% chmod 755 /tmp/funs/{cx,yp}
  1249. X% yp egsirer
  1250. Xegsirer:*:3214:35:Emin Gun Sirer:/u/egsirer:/bin/sh
  1251. X% functions yp
  1252. Xyp () {
  1253. X        ypmatch $1 passwd.byname
  1254. X}
  1255. X
  1256. X
  1257. XThis idea has other benefits.  By adding a #! header to  the
  1258. Xfiles, you can make them double as shell scripts.  (Although
  1259. Xit is faster to use them as functions, since a separate pro-
  1260. Xcess is not created.)
  1261. X
  1262. X% ed /tmp/funs/yp
  1263. X25
  1264. Xi
  1265. X#! /usr/local/bin/zsh
  1266. Xw
  1267. X42
  1268. Xq
  1269. X% </tmp/funs/yp
  1270. X#! /usr/local/bin/zsh
  1271. Xypmatch $1 passwd.byname
  1272. X% /tmp/funs/yp sukthnkr
  1273. Xsukthnkr:*:1267:35:Rahul Sukthankar:/u/sukthnkr:/usr/princeton/bin/tcsh
  1274. X
  1275. X
  1276. XNow other people, who may not use zsh, or who don't want  to
  1277. Xcopy  all  of  your .zshrc, may use these functions as shell
  1278. Xscripts.
  1279. X
  1280. XDirectories
  1281. X
  1282. XOne nice feature of zsh is the way  it  prints  directories.
  1283. XFor example, if we set the prompt like this:
  1284. X
  1285. Xphoenix% PROMPT='%~> '
  1286. X~> cd src
  1287. X~/src>
  1288. X
  1289. X
  1290. Xthe shell will print the current directory  in  the  prompt,
  1291. Xusing  the  ~  character.  However, zsh is smarter than most
  1292. Xother shells in this respect:
  1293. X
  1294. X
  1295. X
  1296. X
  1297. X
  1298. X
  1299. X                           - 10 -
  1300. X
  1301. X~/src> cd ~subbarao
  1302. X~subbarao> cd ~maruchck
  1303. X~maruchck> cd lib
  1304. X~maruchck/lib> cd fun
  1305. X~maruchck/lib/fun> foo=/usr/princeton/common/src
  1306. X~maruchck/lib/fun> cd ~foo
  1307. X~foo> cd ..
  1308. X/usr/princeton/common> cd src
  1309. X~foo> cd news/nntp
  1310. X~foo/news/nntp> cd inews
  1311. X~foo/news/nntp/inews>
  1312. X
  1313. X
  1314. XNote that zsh prints other users' directories  in  the  form
  1315. X~user.  Also note that you can set a parameter and use it as
  1316. Xa directory name; zsh will act as if foo is a user with  the
  1317. Xlogin  directory  /usr/princeton/common/src.   This  is con-
  1318. Xvenient, especially if you're sick of  seeing  prompts  like
  1319. Xthis:
  1320. X
  1321. Xphoenix:/usr/princeton/common/src/X.V11R4/contrib/clients/xv/docs>
  1322. X
  1323. X
  1324. XIf you get stuck in this position, you can give the  current
  1325. Xdirectory a short name, like this:
  1326. X
  1327. X/usr/princeton/common/src/news/nntp/inews> inews=$PWD
  1328. X/usr/princeton/common/src/news/nntp/inews> echo ~inews
  1329. X/usr/princeton/common/src/news/nntp/inews
  1330. X~inews>
  1331. X
  1332. X
  1333. XWhen you reference a directory in the form ~inews, the shell
  1334. Xassumes  that you want the directory displayed in this form;
  1335. Xthus simply typing echo  ~inews  or  cd  ~inews  causes  the
  1336. Xprompt to be shortened.  You can define a shell function for
  1337. Xthis purpose:
  1338. X
  1339. X~inews> namedir () { $1=$PWD ;  : ~$1 }
  1340. X~inews> cd /usr/princeton/bin
  1341. X/usr/princeton/bin> namedir pbin
  1342. X~pbin> cd /var/spool/mail
  1343. X/var/spool/mail> namedir spool
  1344. X~spool> cd .msgs
  1345. X~spool/.msgs>
  1346. X
  1347. X
  1348. XYou may want to add this one-line function to your .zshrc.
  1349. X
  1350. Xzsh can also put the current directory in your title bar, if
  1351. Xyou  are  using  a  windowing system.  One way to do this is
  1352. Xwith the chpwd function, which is automatically executed  by
  1353. Xthe  shell  whenever you change directory.  If you are using
  1354. Xxterm, this will work:
  1355. X
  1356. Xchpwd () { print -Pn '^[]2;%~^G' }
  1357. X
  1358. X
  1359. XThe -P option tells print to  treat  its  arguments  like  a
  1360. X
  1361. X
  1362. X
  1363. X
  1364. X
  1365. X                           - 11 -
  1366. Xprompt  string; otherwise the %~ would not be expanded.  The
  1367. X-n option suppresses the terminating newline, as with echo.
  1368. X
  1369. XIf you are using an IRIS wsh, do this:
  1370. X
  1371. Xchpwd () { print -Pn '^[P1.y%~^[' }
  1372. X
  1373. X
  1374. XThe print -D command has other uses.  For example, to  print
  1375. Xthe  current directory to standard output in short form, you
  1376. Xcan do this:
  1377. X
  1378. X% print -D $PWD
  1379. X~subbarao/src
  1380. X
  1381. X
  1382. Xand to print each component of the path in short form:
  1383. X
  1384. X% print -D $path
  1385. X/bin /usr/bin ~locbin ~locbin/X11 ~/bin
  1386. X
  1387. X
  1388. X
  1389. XDirectory Stacks
  1390. X
  1391. XIf you use csh, you may know about  directory  stacks.   The
  1392. Xpushd  command  puts the current directory on the stack, and
  1393. Xchanges to a new directory; the popd command pops  a  direc-
  1394. Xtory off the stack and changes to it.
  1395. X
  1396. Xphoenix% cd
  1397. Xphoenix% PROMPT='Z %~> '
  1398. XZ ~> pushd /tmp
  1399. X/tmp ~
  1400. XZ /tmp> pushd /usr/etc
  1401. X/usr/etc /tmp ~
  1402. XZ /usr/etc> pushd /usr/bin
  1403. X/usr/bin /usr/etc /tmp ~
  1404. XZ /usr/bin> popd
  1405. X/usr/etc /tmp ~
  1406. XZ /usr/etc> popd
  1407. X/tmp ~
  1408. XZ /tmp> pushd /etc
  1409. X/etc /tmp ~
  1410. XZ /etc> popd
  1411. X/tmp ~
  1412. X
  1413. X
  1414. Xzsh's directory stack commands work similarly.  One  differ-
  1415. Xence  is the way pushd is handled if no arguments are given.
  1416. XAs in csh, this exchanges the top two elements of the direc-
  1417. Xtory stack:
  1418. X
  1419. XZ /tmp> dirs
  1420. X/tmp ~
  1421. XZ /tmp> pushd
  1422. X~ /tmp
  1423. X
  1424. X
  1425. Xunless the stack only has one entry:
  1426. X
  1427. X
  1428. X
  1429. X
  1430. X
  1431. X                           - 12 -
  1432. X
  1433. XZ ~> popd
  1434. X/tmp
  1435. XZ /tmp> dirs
  1436. X/tmp
  1437. XZ /tmp> pushd
  1438. X~ /tmp
  1439. X
  1440. X
  1441. Xor unless the PUSHDTOHOME option is set:
  1442. X
  1443. XZ ~> setopt pushdtohome
  1444. XZ ~> pushd
  1445. X~ ~ /tmp
  1446. X
  1447. X
  1448. X
  1449. XAs an alternative to using directory stacks in this  manner,
  1450. Xwe  can  get something like a directory history by setting a
  1451. Xfew more options and parameters:
  1452. X
  1453. X~> DIRSTACKSIZE=8
  1454. X~> setopt autopushd pushdminus pushdsilent pushdtohome
  1455. X~> alias dh='dirs -v'
  1456. X~> cd /tmp
  1457. X/tmp> cd /usr
  1458. X/usr> cd bin
  1459. X/usr/bin> cd ../pub
  1460. X/usr/pub> dh
  1461. X0       /usr/pub
  1462. X1       /usr/bin
  1463. X2       /usr
  1464. X3       /tmp
  1465. X4       ~
  1466. X/usr/pub> cd -3
  1467. X/tmp> dh
  1468. X0       /tmp
  1469. X1       /usr/pub
  1470. X2       /usr/bin
  1471. X3       /usr
  1472. X4       ~
  1473. X/tmp> ls =2/df
  1474. X/usr/bin/df
  1475. X/tmp> cd -4
  1476. X~>
  1477. X
  1478. X
  1479. XNote that =2 expanded to the second directory in the history
  1480. Xlist,  and  that  cd  -3 recalled the third directory in the
  1481. Xlist.
  1482. X
  1483. XYou may be wondering what all those options  do.   AUTOPUSHD
  1484. Xmade  cd act like pushd.  (alias cd=pushd is not sufficient,
  1485. Xfor various reasons.) PUSHDMINUS swapped the meaning  of  cd
  1486. X+1 and cd -1; we want them to mean the opposite of what they
  1487. Xmean in csh, because it makes more sense in this scheme, and
  1488. Xit's easier to type:
  1489. X
  1490. X
  1491. X
  1492. X
  1493. X
  1494. X
  1495. X
  1496. X
  1497. X                           - 13 -
  1498. X
  1499. X~> dh
  1500. X0       ~
  1501. X1       /tmp
  1502. X2       /usr/pub
  1503. X3       /usr/bin
  1504. X4       /usr
  1505. X~> unsetopt pushdminus
  1506. X~> cd +1
  1507. X/tmp> dh
  1508. X0       /tmp
  1509. X1       ~
  1510. X2       /usr/pub
  1511. X3       /usr/bin
  1512. X4       /usr
  1513. X/tmp> cd +2
  1514. X/usr/pub>
  1515. X
  1516. X
  1517. XPUSHDSILENT keeps the  shell  from  printing  the  directory
  1518. Xstack  each  time  we  do a cd, and PUSHDTOHOME we mentioned
  1519. Xearlier:
  1520. X
  1521. X/usr/pub> unsetopt pushdsilent
  1522. X/usr/pub> cd /etc
  1523. X/etc /usr/pub /tmp ~ /usr/bin /usr
  1524. X/etc> cd
  1525. X~ /etc /usr/pub /tmp ~ /usr/bin /usr
  1526. X~> unsetopt pushdtohome
  1527. X~> cd
  1528. X/etc ~ /usr/pub /tmp ~ /usr/bin /usr
  1529. X/etc>
  1530. X
  1531. X
  1532. XDIRSTACKSIZE keeps the  directory  stack  from  getting  too
  1533. Xlarge, much like HISTSIZE:
  1534. X
  1535. X/etc> setopt pushdsilent
  1536. X/etc> cd /
  1537. X/> cd /
  1538. X/> cd /
  1539. X/> cd /
  1540. X/> cd /
  1541. X/> cd /
  1542. X/> cd /
  1543. X/> cd /
  1544. X/> dh
  1545. X0       /
  1546. X1       /
  1547. X2       /
  1548. X3       /
  1549. X4       /
  1550. X5       /
  1551. X6       /
  1552. X7       /
  1553. X
  1554. X
  1555. X
  1556. X
  1557. X
  1558. X
  1559. X
  1560. X
  1561. X
  1562. X
  1563. X                           - 14 -
  1564. XCommand/Process Substitution
  1565. X
  1566. XCommand substitution in zsh can  take  two  forms.   In  the
  1567. Xtraditional  form,  a command enclosed in backquotes (`...`)
  1568. Xis replaced on the command line with its  output.   This  is
  1569. Xthe  form used by the older shells.  Newer shells (like zsh)
  1570. Xalso provide another form, $(...).  This form is much easier
  1571. Xto nest.
  1572. X
  1573. X% ls -l `echo /vmunix`
  1574. X-rwxr-xr-x  1 root      1209702 May 14 19:04 /vmunix
  1575. X% ls -l $(echo /vmunix)
  1576. X-rwxr-xr-x  1 root      1209702 May 14 19:04 /vmunix
  1577. X% who | grep mad
  1578. Xsubbarao ttyt7   May 23 15:02   (mad55sx15.Prince)
  1579. Xpfalstad ttyu1   May 23 16:25   (mad55sx14.Prince)
  1580. Xsubbarao ttyu6   May 23 15:04   (mad55sx15.Prince)
  1581. Xpfalstad ttyv3   May 23 16:25   (mad55sx14.Prince)
  1582. X% who | grep mad | awk '{print $2}'
  1583. Xttyt7
  1584. Xttyu1
  1585. Xttyu6
  1586. Xttyv3
  1587. X% cd /dev; ls -l $(who |
  1588. X> grep $(echo mad) |
  1589. X> awk '{ print $2 }')
  1590. Xcrwx-w----  1 subbarao  20,  71 May 23 18:35 ttyt7
  1591. Xcrw--w----  1 pfalstad  20,  81 May 23 18:42 ttyu1
  1592. Xcrwx-w----  1 subbarao  20,  86 May 23 18:38 ttyu6
  1593. Xcrw--w----  1 pfalstad  20,  99 May 23 18:41 ttyv3
  1594. X
  1595. X
  1596. XMany common  uses  of  command  substitution,  however,  are
  1597. Xsuperseded by other mechanisms of zsh:
  1598. X
  1599. X% ls -l `tty`
  1600. Xcrw-rw-rw-  1 root      20,  28 May 23 18:35 /dev/ttyqc
  1601. X% ls -l $TTY
  1602. Xcrw-rw-rw-  1 root      20,  28 May 23 18:35 /dev/ttyqc
  1603. X% ls -l `which rn`
  1604. X-rwxr-xr-x  1 root       172032 Mar  6 18:40 /usr/princeton/bin/rn
  1605. X% ls -l =rn
  1606. X-rwxr-xr-x  1 root       172032 Mar  6 18:40 /usr/princeton/bin/rn
  1607. X
  1608. X
  1609. XA command name with a = prepended is replaced with its  full
  1610. Xpathname.   This  can  be very convenient.  If it's not con-
  1611. Xvenient for you, you can turn it off:
  1612. X
  1613. X% ls
  1614. X=foo    =bar
  1615. X% ls =foo =bar
  1616. Xzsh: foo not found
  1617. X% setopt noequals
  1618. X% ls =foo =bar
  1619. X=foo    =bar
  1620. X
  1621. X
  1622. X
  1623. XAnother nice feature is process substitution:
  1624. X
  1625. X
  1626. X
  1627. X
  1628. X
  1629. X                           - 15 -
  1630. X
  1631. X% who | fgrep -f =(print -l root lemke shgchan subbarao)
  1632. Xroot     console May 19 10:41
  1633. Xlemke    ttyq0   May 22 10:05   (narnia:0.0)
  1634. Xlemke    ttyr7   May 22 10:05   (narnia:0.0)
  1635. Xlemke    ttyrd   May 22 10:05   (narnia:0.0)
  1636. Xshgchan  ttys1   May 23 16:52   (gaudi.Princeton.)
  1637. Xsubbarao ttyt7   May 23 15:02   (mad55sx15.Prince)
  1638. Xsubbarao ttyu6   May 23 15:04   (mad55sx15.Prince)
  1639. Xshgchan  ttyvb   May 23 16:51   (gaudi.Princeton.)
  1640. X
  1641. X
  1642. XA command of the form =(...) is replaced with the name of  a
  1643. Xfile containing its output.  (A command substitution, on the
  1644. SHAR_EOF
  1645. true || echo 'restore of zsh2.2/doc/intro.txt failed'
  1646. fi
  1647. echo 'End of zsh2.2 part 1'
  1648. echo 'File zsh2.2/doc/intro.txt is continued in part 2'
  1649. echo 2 > _shar_seq_.tmp
  1650. exit 0
  1651.  
  1652. exit 0 # Just in case...
  1653.